Skip to content

Conversation

@AThousandShips
Copy link
Member

Several areas missing but as a starting point to figure out the specifics

@Mickeon
Copy link
Member

Mickeon commented Oct 22, 2025

Is it necessary to specify @godotengine/documentation every time? Can it not be just once, encompassing multiple paths at once?

Edit: I see you've done right just this at the end of the file, so why doing it for every other line?

@AThousandShips
Copy link
Member Author

It cannot be done once only, unfortunately, it would be great if it worked that way but it doesn't

/tutorials/export/*ios* @godotengine/ios @godotengine/documentation
/tutorials/export/*linux* @godotengine/linux-bsd @godotengine/documentation
/tutorials/export/*macos* @godotengine/macos @godotengine/documentation
/tutorials/export/*visionos* @godotengine/ios @godotengine/documentation
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There isn't a specific team for this, so unsure what to add here, ownership is also missing from the main repo for this platform


/*.* @godotengine/documentation

# TODO: Should the build related files, like `.py` be owned by the doc team or buildsystem?
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would make them owned by the buildsystem team.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Then I'll add them and see what cases are relevant, might make the root folder buildsystem and filter more finely for the global assignment for documentation

@AThousandShips
Copy link
Member Author

There cleaned up the formatting and added some new entries, will continue next week!


## --------------- Plugins -------------------------

# TODO: Who should control this beyond documentation?
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We don't have an 'editor' team right now (we should!); currently i'd say "Docks" is the closest match?


## --------------- Scripting -----------------------

# TODO: Who should control this in general beyond documentation?
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Scripting is technically owned by Core, but the gdscript and dotnet teams should be better familiar with the APIs. The information in here seems to be a mix of all, maybe we need to do it on a case by case basis.

Comment on lines 190 to 200
## --------------- XR ------------------------------

/tutorials/xr/ @godotengine/documentation @godotengine/xr

# TODO: Should any of these also have rendering ownership when rendering related?
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Forwarding this question to @godotengine/xr


## --------------- i18n ----------------------------

# TODO: Who should control this beyond documentation?
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think translations has a dedicated team. Historically I think some maintainers have been contributing to this area more than others though, so there is certainly some 'inofficial ownership' here too.
In the main repo, PRs for translations end up in core, though I'm not sure it's a great fit. Perhaps this also needs a dedicated team?

Copy link
Member

@Mickeon Mickeon Oct 29, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We genuinely need to discuss more team subdivisions. See how some topics aren't a perfect match and some are missing, and you can understand why I have a personal tendency to bring this topic up where it doesn't fit.

When this specific section shows up, it's usually argued it belongs in usability.

/tutorials/editor/ @godotengine/documentation @godotengine/docks
/tutorials/editor/*script* @godotengine/documentation @godotengine/script-editor

# TODO: Who should control this beyond docs?
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'd attribute it to docks, since that's the closest we have to an editor team.
But I'd also argue we should establish an editor team 😅


## --------------- Best Practices ------------------

# TODO: Who should control this beyond documentation?
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We probably need to do this either on a file-by-file basis, or case-by-case basis.


# ---------------- Community -----------------------

# TODO: Who should control this beyond documentation?
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Probably the @godotengine/communication team?

@AThousandShips
Copy link
Member Author

Thank you for your suggestions! Will go over this again some time this week

@AThousandShips
Copy link
Member Author

Applied a few of the suggestions and will see about additional cases next week

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants